package com.bookrecomm.service;

import com.bookrecomm.entity.Category;
import com.bookrecomm.vo.CategoryVO;

import java.util.List;

/**
 * 分类服务接口
 * 定义分类相关的业务逻辑方法
 */
public interface CategoryService {

    /**
     * 获取所有分类列表
     * @return 分类列表
     */
    List<CategoryVO> findAll();

    /**
     * 获取分类树
     * @return 分类树
     */
    List<CategoryVO> findCategoryTree();
    
    /**
     * 获取原始分类数据(调试用)
     * @return 原始分类数据列表
     */
    List<Category> findRawCategories();

    /**
     * 根据ID查询分类
     * @param id 分类ID
     * @return 分类信息
     */
    CategoryVO findById(Long id);

    /**
     * 根据父ID查询子分类
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<CategoryVO> findByParentId(Long parentId);

    /**
     * 添加分类
     * @param category 分类信息
     * @return 添加后的分类信息
     */
    CategoryVO addCategory(Category category);

    /**
     * 更新分类
     * @param id 分类ID
     * @param category 分类信息
     * @return 更新后的分类信息
     */
    CategoryVO updateCategory(Long id, Category category);

    /**
     * 删除分类
     * @param id 分类ID
     * @return 是否删除成功
     */
    boolean deleteCategory(Long id);
}
